home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / icon tools / mwb2ni / docs / mwb2ni.doc next >
Text File  |  1996-04-07  |  6KB  |  184 lines
  1. some quick documentation for "MWB2NI"
  2.  
  3. So,  you've  discovered  that  nifty  system-patch, "newicons".  kinda
  4. cool, huh?  but man, do those iso-icons ever suck?  you think you
  5. could convert all your magic-wb icons by using a cut-paste-inject, but
  6. for *each* icon?!? no way.  well, that's where mwb2ni comes into play.
  7.  
  8. to install it, just do the following:
  9.  
  10. copy c/mwb2ni to c:
  11.  
  12. hard, huh?  you might want to use a dir-util if you can't do that
  13. manually.
  14.  
  15. then, you can convert a single icon by doing this:
  16.  
  17. mwb2ni icon.info
  18.  
  19. you'll have to include the .info!  mwb2ni isn't smart enough to do it
  20. by itself.
  21.  
  22. you can convert a bunch of icons by doing this:
  23.  
  24. mwb2ni sys:paint/#?.info
  25.  
  26. or even,
  27.  
  28. mwb2ni sys:#? sys:tools/#? sys:paint/#? text:#? storage:incoming/#?
  29.  
  30. you get the picture...
  31.  
  32. now, there are some options available to optimize the conversion.
  33. we'll go through them one by one.
  34.  
  35. O=OFFSET/N
  36.  
  37. this is a numerical value that describes where your four magic-wb
  38. colors are located.  if you're smart, then these will be at location
  39. 4.  (this is the default, btw.)  if you're using an older magic-wb
  40. set, then they'll be up at 252.  (this is also refered to as
  41. eight-planes).  if the default doesn't work, then try 252.  if that
  42. doesn't work, try 12, then 28, then 60, then 124.  if all those
  43. fail, then you're fucked.
  44.  
  45. DOT=CLEAROLD/S
  46.  
  47. this switch makes the old image into a "dot" to save both disk space
  48. and memory.  but, only use this when you're *sure* you don't need the
  49. original old-image anymore.  you can possibly convert the newicon back
  50. to the old-image, but don't bet on it.  maybe you could do a "lha -r
  51. -x a oldicons #?.info" to your harddisks???
  52.  
  53. REDO/S
  54.  
  55. this forces a conversion of an exsisting newicon file.  you can do this
  56. if you get the colors (offset) wrong, or you want to use the dot
  57. switch.
  58.  
  59.  
  60.  
  61. if you want to convert an entire directory and all it's
  62. sub-directories, try this:
  63.  
  64. cd directory
  65. list #? all dirs lformat "mwb2ni %s%s/#?" >ram:exme nohead
  66. execute ram:exme
  67.  
  68. btw, this is included as a script.  just use
  69.  
  70. convertall       (if you're in the directory, or:)
  71. convertall sys:  (if you want to specify a directory)
  72. convertallkill   (same as convertall, but makes "dots" for old images)
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80. some personal notes on "newicons", nicola salmoria, and roger mcvey...
  81.  
  82. read carefully.  contains flames.  these are OPINIONS and not to be
  83. taken seriously.  each person in the world should be ENTITLED to
  84. his/her own OPINION.
  85.  
  86. first off, newicons (the program) is very nice.  but, nicola's
  87. attitude put me off working with him on joint projects, very quickly.
  88. and i won't even mention that i personally dislike those iso-icons,
  89. nor trying to insist that everyone use them.
  90.  
  91. i'm not sure how i first met up with nicola, but we started exchanging
  92. email/files concerning iconian and newicons.  i had offered to support
  93. newicons inside iconian.  he supplied some developer material and
  94. ideas.  i wrote some quick hacks and i had a version of iconian that
  95. read and wrote 256 color newicons.  i gave it to nicola, and he
  96. flew off the handle!  he wanted things a certain way, and would refuse
  97. to listen that i had made the newicon support a HACK.  at that point,
  98. i gave up the idea of working with newicons and nicola.
  99.  
  100. i've saved all my email conversations with him, and i'd like to share
  101. a few highlights of my conversation.  to try and point out why i have
  102. my opinions like i do...
  103.  
  104.  
  105. nicola:
  106. "The program is ready. It has been ready for months, now.
  107. It's only missing documentation and icons. Roger McVey is very busy at the
  108. moment." -- April 24, 1994
  109.  
  110. jeez..it was finally released in November of '94.  had you released it
  111. a year earlier, magic workbench wouldn't have been so widespread.
  112. maybe you wouldn't have to dis it to try and get your package
  113. installed...anyways,
  114.  
  115. nicola:
  116. "It IS possible, however, to directly access the data stored in the
  117. NewIcons - I can provide you routines to do so. Iconian should use a 256
  118. color custom screen, however, not the Workbench screen, otherwise it may
  119. lose information. And should allow to modify the palette, of course."
  120.  
  121. ok, then why did you later tell me this:
  122.  
  123. nicola:
  124. "Using a custom screen shouldn't be necessary. A 12 color icon can easily
  125. be edited on a 32-color Workbench, if you do things right.
  126. The new RemapChunkyImage() fucntion in newicon.library could be helpful
  127. (you did receive it, didn't you?)"
  128.  
  129. i know you say i can use the remapchunkyimage() function, but after
  130. EVERY time i modify the image?  i think not...(overhead)
  131.  
  132. me:
  133. "I'm trying to keep Iconian backwards compatible.  Therefore, I can't
  134. really always use your newicon functions to read/write icons.  Not
  135. everyone has or will have newicon.library (well, no one does...)"
  136.  
  137. nicola:
  138. "Watch carefully the code I sent you. Those functions fall back to
  139. icon.library if NewIconBase is NULL. Using NewDiskObject insternally
  140. is supposed to make things EASIER for you, since you don't have to
  141. handle NewIcons as a special case."
  142.  
  143. yea, right.  your library makes handling 4 buffers instead of 2
  144. invisible to iconian.  dream on.  i still have to handle newicons as a
  145. special case, so why not do it as a special case?  jeez
  146.  
  147. nicola:
  148. ""Open NewIcon" and "Save NewIcon" must disappear. All editing should
  149. be performed via "Open" and "Save"."
  150.  
  151. oh, is that right?  iconian is my program, not yours.  (of course,
  152. this insistment could be language translation problems...hhh)
  153.  
  154. nicola:
  155. "Actually, it would be very nice to have a good icon editor distributed
  156. with NewIcons: it would make things much easier."
  157.  
  158. WAIT A SECOND you want to include iconian (a full blown, 140k program)
  159. with  a  SYSTEM  PATCH?!?   i think not!  you need get your priorities
  160. straight.   i'll  include  and promote your patch with my program, but
  161. not the other way around.  i personally know that my program must have
  162. taken 10x the amount of work your 3k library took.
  163.  
  164. nicola:
  165. "Let me know what you think.  I really need an injection of enthusiasm
  166. to finally finish this project which is almost one year old." -April
  167. 24, 1994
  168.  
  169. wow.  it was released in November.  that makes it 1.5 years old.
  170. older than i thought.
  171.  
  172.  
  173.  
  174. to sum up.  fuck nicola's and roger's idea of an isometric world.  i
  175. say coonvert all your glorious magic-workbench icons to the newicon
  176. format just to piss them off!  ;)  later guys...
  177.  
  178.  
  179. I SWALLOW, I SWALLOW, I SWALLOW, I SWALLOW
  180. Be aggressive, B-e aggressive,
  181. B-e-a-g-g-r-e-s-s-i-v-e
  182. Go, Fight, Go, Fight, Go, Fight, Go, Fight, Win   -- Faith No More
  183.  
  184.